home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / bbsee14.zip / BBSEE.DOC next >
Text File  |  1991-10-12  |  67KB  |  1,997 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.      ░░░░░░░░░░░   ░░░░░░░░░░░    ░░░░░░░░░░  ░░░░░░░░░░░   ░░░░░░░░░░░
  10.      ░░        ░░  ░░        ░░  ░░           ░░            ░░
  11.      ░░        ░░  ░░        ░░  ░░           ░░            ░░
  12.      ░░░░░░░░░░    ░░░░░░░░░░     ░░░░░░░░░░  ░░░░░░░░░░    ░░░░░░░░░░░
  13.      ░░        ░░  ░░        ░░            ░░ ░░            ░░
  14.      ░░        ░░  ░░        ░░            ░░ ░░            ░░
  15.      ░░░░░░░░░░░   ░░░░░░░░░░░    ░░░░░░░░░░  ░░░░░░░░░░░   ░░░░░░░░░░░
  16.  
  17.  
  18.  
  19.      BBSee 1.4 User's Manual And Reference
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.      Copyright (C) 1991  Martin Vallevand
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.      Table of Contents
  36.  
  37.      Chapter 1  General Information  . . . . . . . . . . . . . . . . . . . .   1
  38.           1.1  License . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  39.           1.2  Files on the 'Program' Disk . . . . . . . . . . . . . . . . .   2
  40.           1.4  System requirements . . . . . . . . . . . . . . . . . . . . .   2
  41.           1.4  Background  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  42.           1.5  Credits . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  43.  
  44.      Chapter 2  Configuration  . . . . . . . . . . . . . . . . . . . . . . .   4
  45.           2.1  BBSEE.CFG . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  46.           2.2  General directory and files . . . . . . . . . . . . . . . . .   5
  47.           2.3  Output Directory files  . . . . . . . . . . . . . . . . . . .   6
  48.           2.4  Single word exclusion,  . . . . . . . . . . . . . . . . . . .   7
  49.           2.5  Source / BBS Board Selection  . . . . . . . . . . . . . . . .   7
  50.           2.6  On-Line Help  . . . . . . . . . . . . . . . . . . . . . . . .   8
  51.           2.7  Analyze Directory . . . . . . . . . . . . . . . . . . . . . .   8
  52.           2.8  Colour Installation . . . . . . . . . . . . . . . . . . . . .   8
  53.           2.9  Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . .   9
  54.  
  55.      Chapter 3  File option  . . . . . . . . . . . . . . . . . . . . . . .    10
  56.           3.1  File importation  . . . . . . . . . . . . . . . . . . . . .    10
  57.           3.2  File Duplication  . . . . . . . . . . . . . . . . . . . . .    11
  58.           3.3  Uncompress and Import NEWFILES.DAT  . . . . . . . . . . . .    12
  59.           3.4  Create Record . . . . . . . . . . . . . . . . . . . . . . .    12
  60.           3.5  DOS Shell . . . . . . . . . . . . . . . . . . . . . . . . .    12
  61.           3.6  Record Editing  . . . . . . . . . . . . . . . . . . . . . .    13
  62.  
  63.      Chapter 4  Search Option  . . . . . . . . . . . . . . . . . . . . . .    14
  64.           4.1  Word Search . . . . . . . . . . . . . . . . . . . . . . . .    14
  65.           4.2  Filename Search . . . . . . . . . . . . . . . . . . . . . .    14
  66.           4.3  Output Search List  . . . . . . . . . . . . . . . . . . . .    14
  67.  
  68.      Chapter 5  Catalog option . . . . . . . . . . . . . . . . . . . . . .    16
  69.           5.1  Analyze directory . . . . . . . . . . . . . . . . . . . . .    16
  70.           5.2  Catalog floppy  . . . . . . . . . . . . . . . . . . . . . .    16
  71.           5.3  Uncatalog floppy  . . . . . . . . . . . . . . . . . . . . .    16
  72.           5.4  Label floppy  . . . . . . . . . . . . . . . . . . . . . . .    17
  73.           5.5  Make Catalog File . . . . . . . . . . . . . . . . . . . . .    17
  74.           5.6  Cross Reference . . . . . . . . . . . . . . . . . . . . . .    18
  75.           5.7  Describe Floppy . . . . . . . . . . . . . . . . . . . . . .    18
  76.  
  77.      Chapter 6  Tag option . . . . . . . . . . . . . . . . . . . . . . . .    19
  78.           6.1  Delete tagged file  . . . . . . . . . . . . . . . . . . . .    19
  79.           6.2  Create download file  . . . . . . . . . . . . . . . . . . .    19
  80.           6.3  Remove tags . . . . . . . . . . . . . . . . . . . . . . . .    19
  81.           6.4  View tags . . . . . . . . . . . . . . . . . . . . . . . . .    19
  82.           6.5  Create upload files . . . . . . . . . . . . . . . . . . . .    19
  83.           6.6  Output tags to disk . . . . . . . . . . . . . . . . . . . .    20
  84.  
  85.      Chapter 7  Using the program  . . . . . . . . . . . . . . . . . . . .    21
  86.  
  87.      Chapter 8  Command line arguments . . . . . . . . . . . . . . . . . .    22
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.      Appendix A  Registration Information  . . . . . . . . . . . . . . . .    23
  96.  
  97.      Appendix B  Program Return Codes  . . . . . . . . . . . . . . . . . .    25
  98.  
  99.      Appendix C  Cursor Movement and Editing Keys  . . . . . . . . . . . .    26
  100.  
  101.      Appendix D  Import Usage  . . . . . . . . . . . . . . . . . . . . . .    27
  102.  
  103.      Appendix E  Database Packing  . . . . . . . . . . . . . . . . . . . .    28
  104.  
  105.      Appendix F  Deleted File List Maintenance . . . . . . . . . . . . . .    29
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                   BBSee Version 1.4
  114.  
  115. Chapter 1  General Information
  116.  
  117.      BBSee is a program designed  to simplify the process of finding  files
  118.      on  BBS's  that  you  access,  and  cataloging  files  that  you  have
  119.      downloaded.  It also provides many other functions designed to make up
  120.      and downloading files easier.
  121.  
  122. 1.1  License
  123.  
  124.      BBSee  is a commercial package, that is being distributed as shareware
  125.      for personal  evaluation only.   This  is not public  domain, or  free
  126.      software.  After  a one month period of evaluation,  if you decide not
  127.      to purchase a registered version of  BBSee, you must delete all copies
  128.      of  BBSee, in compressed  or uncompressed form, that  you have in your
  129.      possession.  You are  also allowed, and encouraged, to  distribute the
  130.      shareware  package freely, to  potential users  and on-line  BBS's, as
  131.      long as you do not charge for this service, and you provide a complete
  132.      set of programs as specified in section 1.2 of this document.
  133.  
  134.      BBSee  has  been subject  to  thorough testing,  and  every reasonable
  135.      effort has  been made to  make BBSee  a safe,  fast, and  easy to  use
  136.      package.   However the databases that  BBSee makes, can  easily be the
  137.      largest databases that many  people will ever see on  their computers.
  138.      With such large systems, there are  many ways to corrupt the database,
  139.      including rebooting the computer or powering down during use of BBSee,
  140.      so care is advised. 
  141.  
  142.      Also, it is impossible to test  this program on the many  combinations
  143.      of computer software and hardware available in the PC marketplace, and
  144.      to  anticipate all uses for  software. Therefore all  copies of BBSee,
  145.      and any  program distributed with the  package, shareware, registered,
  146.      or  advanced, are purchased  AS IS, and  Martin Vallevand will  not be
  147.      held  responsible for any damage, to your computer, programs, data, or
  148.      anything else for that matter, that may result from its use.  By using
  149.      BBSee you consent to do so at your own risk.  If you find that this is
  150.      unsatisfactory, DO NOT run BBSee.
  151.  
  152.      To register BBSee contact:
  153.  
  154.      Martin Vallevand
  155.      TAC Systems
  156.      Suite 100
  157.      56 Fourth Avenue
  158.      Ottawa, Ontario
  159.      K1S 2L2
  160.  
  161.      Voice (613)233-1728
  162.  
  163.      For further  information  Martin Vallevand  can  be contacted  on  the
  164.      SYNAPSE BBS.  See Appendix A for further information.
  165.  
  166.                                         Page 1
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                                   BBSee Version 1.4
  175.  
  176. 1.2  Files on the 'Program' Disk
  177.  
  178.      BBSEE.EXE      Program File
  179.      BBSEE.DOC      Documentation
  180.      BBSEE.HLP      On-Line Help File
  181.      BBSETUP.EXE    Modifies BBSEE.CFG
  182.      SAMPLE         A file for use as a test (from SYNAPSE)
  183.      README.2ND     Latest file information.
  184.      REGISTER.FRM   Form used to register BBSee.
  185.      GO.BAT         The first thing most people do.
  186.      WHATS.NEW      Information on new features in this release.
  187.      HISTORY        Revision history for BBSee.
  188.      QUICKST.ART    Start using BBSee now.
  189.      IMPORT.EXE     General BBS file listing conversion utility.
  190.  
  191.      Files on the 'Extras'  Disk
  192.  
  193.      READDEL.EXE    Delete file reader.
  194.      WRITEDEL.EXE   Delete file writer.
  195.      PACBBSEE.EXE   Database 'pack' utility.
  196.  
  197.      READCAT.EXE    Create PCBoard list from CatDisk output.
  198.      WRITECAT.EXE   Update BBSee database from CatDisk output.
  199.      CAT2BBC.DOC    Documentation for the above.
  200.  
  201.      The files  on this  disk  are not  essential to  run  BBSee, but  they
  202.      certainly  will make its use more versatile.  Depending on file import
  203.      needs  other utilities may  be added to  this list.   Check the README
  204.      file for the latest information.
  205.  
  206.  
  207.      System requirements
  208.  
  209.      100% IBM compatible computer.
  210.      MS-DOS 3.30 or higher. (lower versions were not tested)
  211.      Roughly 256K free RAM.
  212.      9 File handles and open DOS files (from config.sys).  
  213.      You must have a line of FILES=14 or more in your CONFIG.SYS file.
  214.      Hard disk strongly recommended.
  215.  
  216.      BBSee will use as much disk space as you'd like to devote to  BBS file
  217.      listings. The faster the disk transfer rate the better.   The addition
  218.      of  disk caching, even  as small as  128K, can improve  performance by
  219.      approx. 500%.
  220.  
  221. 1.4  Background
  222.  
  223.      This program is written in the large model of Borland C++ 2.0, CXL 5.2
  224.      and the  MIX  C/database  toolchest.    I  believe  these  to  all  be
  225.      excellent, inexpensive, packages although  the database package can be
  226.  
  227.                                         Page 2
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                                   BBSee Version 1.4
  236.  
  237.      slow on  adding records to  a large  database.  A  fast string  search
  238.      algorithm, the  Boyer-Moore algorithm, is used  to find words.   To me
  239.      this is  to brute  force searching,  what qsort is  to a  bubble sort.
  240.      Most of the overhead is  in the disk read.  CXL has been superseded by
  241.      TCXL however I found too many bugs in version 5.51 to use it, and have
  242.      not yet tried 5.52.  
  243.  
  244.      BBSee  and  BBSetup  has  been  compressed  with  LZEXE,  and  further
  245.      processed  to disable UNLZEXEing as a very limited means of protecting
  246.      the programs from alteration.   The registered version can  be ordered
  247.      in  uncompressed format if you specify this on the order form.
  248.  
  249.      All the file access in  the BBSee program use standard Turbo  C calls,
  250.      with  the exception of  the routines that manipulate  the label on the
  251.      floppy,  which use  extended  FCBs and  DOS  interrupts.   Other  than
  252.      directly  writing to the floppy disk sectors, I don't believe there is
  253.      another method to write the volume label.  I have  read, that everyone
  254.      should use the  DOS label  program to label  diskettes, for  technical
  255.      reasons, so I will mirror that recommendation.
  256.  
  257.      Regardless of whether you use BBSee or not, I strongly recommend  that
  258.      all users of DOS 4.00 or higher, always run the DOS SHARE.EXE command,
  259.      to protect themselves from deficiencies in the FCB structures in their
  260.      version  of  DOS.    As  well, if  your  drives  support  disk  change
  261.      indication, you  will  be provided  with  better protection  for  your
  262.      valuable archive floppy disks.
  263.  
  264. 1.5  Credits
  265.  
  266.      I would  like to thank  the following people  for assisting me  in the
  267.      development of  this software.  The diligent work of this team of beta
  268.      testers  and proof readers has helped me  so much, and I believe their
  269.      many suggestions have greatly enhanced the functionality of BBSee.
  270.  
  271.      Bernard  "The  Exterminator" Desruisseaux  for  finding  bugs big  and
  272.      small, and for providing many good (and sound) ideas.
  273.  
  274.      Paul "The Cosmetician" Loshuk  for keeping the documentation  and help
  275.      clean, and for prompting me to  take BBSee beyond the simple program I
  276.      first intended.
  277.  
  278.      Michel Tordion, for providing insight, and listening to me babble.
  279.  
  280.      Phil Lachance for his help testing BBSee under Windows.
  281.  
  282.      Angela Tweeddale for  putting up with me showing her  the program, and
  283.      having   to  read  the   documentation  over-and-over  again,  without
  284.      complaint.
  285.  
  286.  
  287.  
  288.                                         Page 3
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                                   BBSee Version 1.4
  297.  
  298.      Daniel Coulombe for allowing SYNAPSE  to be used as the basis  for the
  299.      beta testing, and the 'home' of BBSee.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.                                         Page 4
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.                                   BBSee Version 1.4
  358.  
  359. Chapter 2  Configuration
  360.  
  361. The most complicated portion of using BBSee, is the configuration that must
  362. be done before BBSee  can be run.  BBSee needs to know the location of many
  363. files  and programs, if  you intend to use  all its options.   If you don't
  364. install BBSee properly  then these  options may not  function properly,  or
  365. BBSee  may exit  with an  error code.   Also  BBSee will  overwrite certain
  366. files,  if they  exist, so some  care should  be used  in reviewing default
  367. filenames.  
  368.  
  369. BBSee configuration is performed in a program, BBSETUP.EXE that handles all
  370. aspects  of BBSee  configuration.    Although  this  program  MUST  be  run
  371. initially, it also can be used to reconfigure options at any time.   As you
  372. become  proficient in the use of BBSee,  you will probably go into BBSetup,
  373. many times, to change the inclusion and exclusion word lists.     
  374.  
  375. Note  as a  general rule whenever  user input  is required  in BBSEE.EXE or
  376. BBSETUP.EXE,  selecting <Esc> will cancel the operation, <F1> will get help
  377. if available, <Enter> will select the option or move to the next option and
  378. <Ctrl Enter> will  process an entire set  of choices.   See Appendix C  for
  379. further information.
  380.  
  381.  
  382. 2.1  BBSEE.CFG
  383.  
  384.      All  configuration information  is  contained in  the file  BBSEE.CFG.
  385.      BBSee searches for the file BBSEE.CFG in the default directory, and if
  386.      not found BBSee  searches in the same directory that BBSEE.EXE was run
  387.      from. 
  388.  
  389.      If BBSEE.CFG  is  not  found  in the  above  steps  BBSee  will  abort
  390.      indicating that BBSETUP.EXE must be run first.
  391.  
  392.      To create BBSEE.CFG  it is  necessary to run  the program  BBSETUP.EXE
  393.      first.   Do not create this  file manually.  The rest  of this section
  394.      deals with using this program.
  395.  
  396.  
  397.      BBSetup.
  398.  
  399.      BBSetup is a  DOS program that runs  from the DOS prompt.   It creates
  400.      the  file described above, BBSEE.CFG,  in the default  directory.  You
  401.      can create as  many BBSEE.CFG files as you wish.  The main purpose for
  402.      doing  this would  be to maintain  separate database  files, exclusion
  403.      lists and floppy catalogs.
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                                         Page 5
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.                                   BBSee Version 1.4
  419.  
  420.      The main menu for BBSETUP.EXE is as follows:
  421.  
  422.                      ╒═════ BBSee Configuration ═════╕
  423.                      │ General directories and files │
  424.                      │ Output directory files        │
  425.                      │ ───────────────────────────── │
  426.                      │ Single word exclusions        │
  427.                      │ Paired word exclusions        │
  428.                      │ File extension exclusions     │
  429.                      │ Required Words                │
  430.                      │ BBS/Source names              │
  431.                      │ ───────────────────────────── │
  432.                      │ Analyze Directory             │
  433.                      │ Colour Installation           │
  434.                      │ Miscellaneous                 │
  435.                      │ Exit                          │
  436.                      ╘═══════════════════════════════╛
  437.  
  438.  
  439. 2.2  General directory and files
  440.  
  441.      The directories and filenames for all files used by BBSee are outlined
  442.      in  this section.  Note that the  sub-directory mentioned should be of
  443.      the  form drive:\subdirectory with no trailing backslash.  If you must
  444.      use  the root directory,  which I don't recommend,  DO NOT include the
  445.      backslash.  These  fields are checked  for the existence of  drives or
  446.      directories,  however you should ensure that they are correct.  PLEASE
  447.      BE CAREFUL.
  448.  
  449.      The first  step in configuration  is to enter  the name of  the master
  450.      database  and  the catalog  database.   The  reason that  the database
  451.      filenames are not fixed  is to allow  multiple BBS list databases  and
  452.      disk catalogs, in separate sub-directories, if desired.  
  453.  
  454.      BBSee creates in total five permanent database files,
  455.      1.  the master database file and index, (mastername.DB and .IDX),
  456.      2.  the floppy catalog file and index, (catalogname.DB and .IDX),
  457.      3.  the index of deleted files, ( mastername.DEL ).  
  458.  
  459.      The  BBS description directory is the sub-directory where most of your
  460.      file description lists will  be located.  This can be  modified during
  461.      the import function of BBSee.
  462.  
  463.      The  Download   File  directory   is  the  sub-directory   where  your
  464.      telecommunication program  places downloaded files.   This is  used in
  465.      the Analyze Directory option of Catalog.
  466.  
  467.      Archive  Files directory  is  the sub-directory  where files  could be
  468.      moved after being downloaded,  but before being moved to  floppy disk.
  469.      This is also used in the Analyze Directory option.
  470.  
  471.                                         Page 6
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                   BBSee Version 1.4
  480.  
  481.      Qmail  File directory is the  sub-directory where your  .QWK files are
  482.      kept.   NEWFILES.DAT files in  the .QWK  files, can be  extracted from
  483.      these files and imported into  the master database.  Other .QWK  files
  484.      in  other sub-directories  on  the  same  drive  can  be  selected  by
  485.      navigating  through the disk using the cursor.  This directory is used
  486.      in the Import/Unzip Newfiles option.
  487.  
  488.      PKUNZIP directory is the sub-directory where PKUNZIP.EXE exists.  This
  489.      is also needed in the Import/Unzip Newfiles option.
  490.  
  491.      The  Output  directory is  the working  directory  for BBSee  to place
  492.      temporary files, and to locate most   output files.  See the following
  493.      section on output directory files for further information.
  494.  
  495.      The Tag files directory is where BBSee places the download  and upload
  496.      files  from the tagged file option. The extension field should contain
  497.      the  extension that  will be  appended to  the output file  that BBSee
  498.      creates,  depending  on  whether the  upload  or  download  option was
  499.      selected within BBSee.   A blank is possible.   The first part of  the
  500.      filename will be the name of the BBS.  This feature is intended  to be
  501.      used with automated file/mail management programs, such as Access(QMM)
  502.      Liberator, and Intellicomm.
  503.  
  504. 2.3  Output Directory files
  505.  
  506.      This screen contains the  default filenames for the files,  other than
  507.      the databases, created by BBSee.  All of these files are placed in the
  508.      output directory.  If you don't want to create a file for any of these
  509.      options, specify NUL as the filename.
  510.  
  511.      The Added file list  is the filename used  as output of all  new files
  512.      added to the database.  This is useful when batch updates of files are
  513.      undertaken, however  for the most part  I recommend NUL  as the device
  514.      for this option, as it causes a lot of disk overhead.
  515.  
  516.      The  Discard  file  is  the  name  of the  file  that  is  to  contain
  517.      information about files that were discarded during the import process,
  518.      for each of the  various rules used in the import. Note that this file
  519.      is opened in append mode. I  suggest that you use the NUL  device once
  520.      you have  a reasonable idea  of how  data is imported.  While learning
  521.      BBSee  I suggest that you create this  discard file, and examine it to
  522.      see  what BBSee rejects, until  you are satisfied  with your exclusion
  523.      word lists.
  524.  
  525.      The Duplicate  file shows  filenames and  descriptions  when there  is
  526.      potential   for  a  description  change.    A  '>'  indicates  that  a
  527.      description  was replaced.  This  file should be  watched carefully as
  528.      the  potential  exists  that  file  descriptions  will  not match  the
  529.      filename  that is duplicated.  Filenames with 3 or fewer characters in
  530.      the filename will not  have their descriptions replaced, as  the short
  531.  
  532.                                         Page 7
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                   BBSee Version 1.4
  541.  
  542.      filenames  are often not unique,  especially when you  access many BBS
  543.      sources.
  544.  
  545.      The Word Search Output file  is the file which BBSee creates  when you
  546.      output the results of a search or the  output of tagged files to disk.
  547.      This is  a PCBoard-like file  with the inclusion  of the BBS  and file
  548.      catalog  locations.  Output to  this file will be  added to the end of
  549.      the file if the indicated file is found.
  550.  
  551.      The two  catalogs files are the  output files chosen in  the output of
  552.      the floppy catalog option.  See Section 5.5 for further information.
  553.  
  554.      The cross  reference extension is the  extension used in making  a BBS
  555.      cross reference file.  See Section 5.6 for further information.
  556.  
  557.      The floppy description  file is  the output from  the Describe  Floppy
  558.      option of catalog.  See Section 5.7 for further information.
  559.  
  560.      The usage  log is a facility that allows you to log certain activities
  561.      within  BBSee.  The main purpose is  to log additions to the database,
  562.      for those people that want to monitor database growth.
  563.  
  564. 2.4  Single word exclusion,
  565.      Paired word exclusions,
  566.      File extension exclusion and
  567.      Required words.
  568.  
  569.      These  options allow  for  processing of  file  descriptions based  on
  570.      certain  words,  (actually strings)  so that  the  file can  either be
  571.      included, or excluded  from addition to  the BBSee  database.  If  you
  572.      include  and exclude words 'smartly' the  size of your database can be
  573.      greatly  limited.  Note,  if for example,  you specify to  exclude the
  574.      word 'windows' (you do not want all files associated with Windows v3.0
  575.      to be in  you database);  should you later  start running Windows  and
  576.      want files  and accompanying  descriptions  to be  included, you  must
  577.      reread in  the  entire original  file list(s).   A  certain amount  of
  578.      thought,  both about your present and future computing needs should be
  579.      done before deciding on words to exclude and include.  
  580.  
  581.      Some strings  may be better  specified as  words, ie you  may wish  to
  582.      exclude descriptions with the word BMP, forgetting that it is included
  583.      in some words  ( IBMPC ).  To  include an entire word use  the leading
  584.      and/or trailing spaces by enclosing the word with the space in  double
  585.      quotes.  ("gif ", " pcx "," bmp", etc.).
  586.  
  587. 2.5  Source / BBS Board Selection
  588.  
  589.      The third  part of the configuration  is a list of the  BBS names that
  590.      you  plan to  include  in the  list.    The order  of  these names  is
  591.      important.     See  the  section   on  file  duplication  for  further
  592.  
  593.                                         Page 8
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                                   BBSee Version 1.4
  602.  
  603.      information. You can also  include the name of a friend as  a 'BBS' if
  604.      you intend to share file lists.  The Format and Options selections are
  605.      used in processing non-PCBoard files.
  606.  
  607.      Note  that the shareware version of BBSee  allows up to 3 BBS sources,
  608.      plus one UNKNOWN  source.  There also is an  advanced version of BBSee
  609.      available which will allow 14 BBS sources, plus the UNKNOWN source.
  610.  
  611. 2.6  On-Line Help
  612.  
  613.      The file  BBSEE.HLP provides  on-line  help for  BBSee.   It  must  be
  614.      located  in the  same subdirectory  as BBSEE.EXE.   This  is  to allow
  615.      running BBSee  from a path.   As such, no configuration  is necessary.
  616.      BBSee will run without this file, it simply  produces an error message
  617.      when the help function is called.
  618.  
  619.      Online   help  is  not  meant   as  a  substitute   for  reading  this
  620.      documentation,  but as  a quick  reference to certain  menu functions.
  621.      The help  is available by pressing F1 from almost any menu or sub-menu
  622.      option.
  623.  
  624. 2.7  Analyze Directory
  625.  
  626.      This option provides a means to  create a personalized batch file that
  627.      can process files on your computer in any manor you wish.  The ~ macro
  628.      allows substitution  of default  directory information into  the batch
  629.      file  when the  batch file  is created.   This information  comes from
  630.      other options within  BBSETUP.EXE.  NOTE that  lines two and  three of
  631.      this batch file ONLY apply to files with the .ZIP extension.
  632.  
  633.      There  are two files created in  the Output Directory for this option,
  634.      which are  set by the top two fields on  this screen.  See Section 5.1
  635.      for a detailied explanation of how these files are created and used.
  636.  
  637. 2.8  Colour Installation
  638.  
  639.      This option will allow for setting up colours within the various menus
  640.      of  BBSee.   In the  shareware version  you are  able to  explore this
  641.      feature, but it will not save changes for any option except the Search
  642.      Window.  The  advanced version  of BBSee will  provide further  colour
  643.      configuration capabilities.
  644.  
  645.      As  well,  if  you  a  have  a  CGA  that  produces  flicker,  flicker
  646.      elimination can be  obtained by  instructing BBSee to  wait for  video
  647.      retraces  before writes.  Mono  mode disables colour  settings for use
  648.      with  monochrome monitors.   Enter  a Y  in the  appropriate field  to
  649.      enable these selections.
  650.  
  651.  
  652.  
  653.  
  654.                                         Page 9
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                                   BBSee Version 1.4
  663.  
  664. 2.9  Miscellaneous
  665.  
  666.      Under this  option  there are  data fields  that are  used in  various
  667.      functions of  BBSee.  The file date option excludes files older than a
  668.      certain  date from being added  to the database.   This exclusion date
  669.      default  is  not  permanent,  it  can be  modified  in  the  File menu
  670.      selection of  BBSee,  under the  "Modify Import  Options" sub  option.
  671.      Although you may want to specify that older files, such as pre-1986 be
  672.      excluded,  you must  remember that  some sources  have files  dated as
  673.      early as  01-01-80.  A suggestion  is to browse through  the lists you
  674.      wish to read into BBSee and determine if any of these files exist.
  675.  
  676.      The archive type specifies the archive  method being used for the .QWK
  677.      package.  Presently, only the PKUNZIP program can be used to unarchive
  678.      .QWK  packets.  You must  manually extract the  NEWFILES.DAT file from
  679.      your  .QWK file, if  you use another  archiving program.   This may be
  680.      changed in later versions if there is significant demand.
  681.  
  682.      The effective cps is the  cps rate used to estimate the  download time
  683.      for marked files.  You may wish to change this to match your effective
  684.      modem  speed (ie  270 for  2400 baud  MNP, 1600  for a  USR HST).   Of
  685.      course, the BBS you are calling will have to match your modem speed.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                        Page 10
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                   BBSee Version 1.4
  724.  
  725. Chapter 3  File option
  726.  
  727. The heart  of the BBSee program  is a master database  of file descriptions
  728. that can come from many sources.  File description listings can be imported
  729. from  BBS directory  listings, Qmail  QWK files,  telecommunication program
  730. screen captures and log files, file  output from BBSee itself, and they can
  731. be entered manually.
  732.  
  733.  
  734. 3.1  File importation
  735.  
  736.      Importation  is the  method of  bringing a  file list  into  BBSee and
  737.      processing the  listing, line-by-line,  into a BBSee  database record.
  738.      Because  of the many,  many different list types,  it is impossible to
  739.      guarantee that all files in a list will be included.  
  740.  
  741.      BBS  file  listing,  are  incorporated  into  the  database  using   a
  742.      sequential  read of  a  DOS text  (ASCII) file,  each  line being  one
  743.      record.  The layout of a file description 'record' is one that I  have
  744.      adopted based on  viewing PCBoard file  description listings.   Anyone
  745.      having  definitive specifications is encouraged to  forward them to me
  746.      as  described in  Appendix A.   The  file  "record' layout  that BBSee
  747.      expects is:
  748.  
  749.      filename    position  1-12
  750.      spaces      position 13-14
  751.      filesize    position 15-21
  752.      spaces      position 22-23
  753.      date        position 24-31  ( format mm-dd-yy )
  754.      spaces      position 32-33
  755.      description position 34-80
  756.  
  757.      Any lines that follow this original record with blanks in columns 1-33
  758.      and text  in  columns 34  -  80 are  treated  as continuation  of  the
  759.      description record.   The pipe character | is allowed  to indicate the
  760.      start of a continuation line if it is the first character of a line.
  761.  
  762.      An asterisk in position 32 is allowed.  This sometimes indicates a new
  763.      file in a BBS on-line search.
  764.  
  765.      Data  is incorporated  into the  database from  the parsed  text file,
  766.      using the exceptions input in BBSetup.  The rules built into the BBSee
  767.      import logic function as follow:
  768.  
  769.      -    Filenames must be uppercase.
  770.  
  771.      -    All  descriptions are converted to lower case.  The character set
  772.           is limited to the  extended ascii characters between 32  and 165.
  773.           No allowance is made for code pages.
  774.  
  775.  
  776.                                        Page 11
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.                                   BBSee Version 1.4
  785.  
  786.      -    If  the file contains one of the  required words it is considered
  787.           mandatory.  This file will be added in all instances.
  788.  
  789.      -    Records  with  a  description  containing  two  paired  exclusion
  790.           strings, will not be entered into the database.   
  791.  
  792.      -    Any file description continuation lines that begin with the words
  793.           'Uploaded by .....' or 'Last filedate in  .ZIP ..'  or containing
  794.           'files - New:' will be stripped out.
  795.  
  796.      -    Ending punctation character . and ! are removed.
  797.  
  798.      -    Catalog only descriptions always replaced.
  799.  
  800.      -    Files  descriptions  beginning with  (CRS)  will  have the  (CRS)
  801.           stripped.   the 'Last Revision Date...' string for CRS files will
  802.           also be stripped.
  803.  
  804.      Note that if you manually create a PCBoard-like text file using a text
  805.      editor,  you  should  ensure no  tab  characters  are  in your  output
  806.      document,  as  they   can  make   it  appear  that   the  file   meets
  807.      specifications, when it truly does not.
  808.  
  809.      Another program supplied  in BBSee, IMPORT.EXE, is  intended to assist
  810.      in  the automatic creation of file lists, by parsing non-standard file
  811.      lists into the PCBoard 'standard' that BBSee uses.  In general, if you
  812.      don't know if a BBS is a PCBoard type, run the import file through the
  813.      import program to see if  it meets the PCBoard column specs.   General
  814.      use of this program is outlined in Appendix D.
  815.  
  816.      If this  non-standard BBS  file can be  converted automatically  using
  817.      IMPORT,  BBSee has the capability of performing this conversion when a
  818.      file is  imported.  Simply specify  in BBSetup, that the  file type is
  819.      type AUT, (for automatic), rather than PCB.   If you must do a  manual
  820.      IMPORT,  specify ASK  for the  file type,  and BBSee  will prompt  you
  821.      before importing the file.  See Appendix D for further information.
  822.  
  823.      Note  that the  nature  of  the  database  will  not  allow  automatic
  824.      determination, and indication of various file areas and conferences on
  825.      the BBS.  This is extremely  difficult to detect automatically, and so
  826.      the feature is not available.
  827.  
  828. 3.2  File Duplication
  829.  
  830.      There is a  mechanism in  place to prevent  the addition of  filenames
  831.      with  different descriptions,  sizes,  times and  extensions into  the
  832.      master  database.   Filenames  from description  listings (  excluding
  833.      extension) are compared  to those already  in the database and  if the
  834.      filename  is  found certain  database  modifications  may take  place.
  835.      PRIORITY will be  given to the BBS  names higher on  the configuration
  836.  
  837.                                        Page 12
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                                   BBSee Version 1.4
  846.  
  847.      list of sources  (the lower  number).  The  extension, file date,  and
  848.      file size stored in the database will be that of  the highest priority
  849.      source.  
  850.  
  851.      The same is true of the description, although if the  filename is more
  852.      than  three  characters  long,     the  description  having  the  most
  853.      characters is  stored in the database,  regardless of the source.   No
  854.      method  exists to eliminate this problem, or to prevent replacing file
  855.      descriptions, without  user prompting, which  is not desirable.   This
  856.      number can  be changed if desired, in the File - Modify Import Options
  857.      window.
  858.  
  859. 3.3  Uncompress and Import NEWFILES.DAT
  860.  
  861.      Users  of Qmail  or MarkMail  with offline  mail readers  are probably
  862.      aware that  it is possible to browse  all files new to  the BBS from a
  863.      previous date, offline.   I am not  going to try to explain  how these
  864.      programs works,  rather I'll explain how BBSee handles the importation
  865.      of the new file information contained within them.  If you plan to use
  866.      a BBS  regularly, and it  has the above option,  usually configured as
  867.      doors,  I suggest that you investigate them.
  868.  
  869.      Contained in most .QWK  files downloaded with the 'scan  for newfiles'
  870.      option of  the mail  door turned  on, is  a file  called NEWFILES.DAT.
  871.      BBSee  will allow for a semi-automatic import of this file description
  872.      list  into the  master database.   Within  BBSee, after  selecting the
  873.      Unzip option, use the cursor to  select the .QWK file that you wish to
  874.      import into the database.   After this, select the BBS source  of this
  875.      file.   The file  description records  will then  be entered  into the
  876.      database.  This of course assumes proper configuration of the mail and
  877.      archive file directories. 
  878.  
  879.      If your BBS has this capability, regular use of this feature will keep
  880.      your database up-to-date, and eliminate the need to regularly download
  881.      the entire list of newfiles added to your BBS's.
  882.  
  883. 3.4  Create Record
  884.  
  885.      Using this option  it is possible to  create a master  database entry.
  886.      The best  use for this option is to add unknown files, personal files,
  887.      and obsolete files to the database so that the floppy disk catalog can
  888.      also be  updated.  This file is  not subject to any  of BBSee's import
  889.      'rules'.
  890.  
  891. 3.5  DOS Shell
  892.  
  893.      This  option allows exiting  to DOS to  execute many  DOS programs and
  894.      commands.  Do not run any TSR's, reboot, or turn off you machine while
  895.      you are in  the shell.  To return  to BBSee you must type  the command
  896.  
  897.  
  898.                                        Page 13
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.                                   BBSee Version 1.4
  907.  
  908.      EXIT at the DOS prompt.  It is  better to quit BBSee and come back  if
  909.      you must leave the program for a long period of time.  
  910.  
  911.      If you use  BBSetup in the shell,  the changes you make will  not take
  912.      place, until you quit and execute BBSee.
  913.  
  914. 3.6  Record Editing
  915.  
  916.      There is presently no mechanism in place to edit  an existing database
  917.      record.  If you must  change a record,  you must create  an ASCII text
  918.      file meeting  PCBoard specifications,  with a description  longer than
  919.      currently in the database, and 'Steal' the description.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                        Page 14
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.                                   BBSee Version 1.4
  968.  
  969. Chapter 4  Search Option
  970.  
  971. Search  for words and/or  filenames.   Outputs the  filename if  found, and
  972. also,  if the filename  has been catalogued  on floppy disk,  the label and
  973. directory of the catalogued floppy can be displayed.
  974.  
  975. 4.1  Word Search
  976.  
  977.      This  option allows  you to  search for  strings within  the database.
  978.      Because of the nature of the search  the most unique word should be in
  979.      the primary word field.  The primary word is searched in all filenames
  980.      and description.  The  qualifier and exception words are  only matched
  981.      in the descrition.
  982.  
  983.      The search on a word continues until  the entire database is read or a
  984.      complete  screen  of  information  is  displayed,  at which  time  the
  985.      filename  will  be highlighted  with  a  selection bar.    It is  then
  986.      possible to select  filenames by moving the selection bar  up and down
  987.      using  the cursor.  Full database information on the selected filename
  988.      is available  by typing the letter  V (for View).   <ESC> will abandon
  989.      the search at this point.  Also see the TAG option.
  990.  
  991.      Hitting a key while a search is  in progress, ie when no selection bar
  992.      is displayed,  will cause a prompt  which will allow you  to abort the
  993.      search.
  994.  
  995.      Typing <Alt L> will lock on the view window until <Alt L> is pressed a
  996.      second  time, or the  <ESC> key is  pressed.  The  default View Window
  997.      lock (On or Off), can be configured in BBSetup.
  998.  
  999. 4.2  Filename Search
  1000.  
  1001.      Using this option  will allow you to perform an  indexed search on the
  1002.      filename.  This is by far the  speediest search, if you have a  pretty
  1003.      good idea of the filename, or you want to look for various versions of
  1004.      a particular file.  This  is equivalent to a PCBoard <L>ocate  without
  1005.      requiring the trailing *.*.
  1006.  
  1007.      To 'browse' the file near the search, the page/cursor up and down keys
  1008.      can be used.  A  file also can be  tagged, using the <keyboard +>  and
  1009.      untagged   using  the  <keyboard  ->  keys.    See  tags  for  further
  1010.      information.
  1011.  
  1012. 4.3  Output Search List
  1013.  
  1014.      This option creates an ASCII  listing of the files that meet  the same
  1015.      search criteria  as an on screen  search.  This listing  is in PCBoard
  1016.      like  format with  the  addition  of  the BBS  source,  and  any  disk
  1017.      cataloging  information  that  you may  have.    This  listing can  be
  1018.      imported into BBSee.  If this file exists it is opened in append mode.
  1019.  
  1020.                                        Page 15
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                                   BBSee Version 1.4
  1029.  
  1030. 4.4  Show All (Catalog)
  1031.  
  1032.      To toggle  the search results  between displaying the  master database
  1033.      information,  to displaying  only  information also  contained in  the
  1034.      floppy catalog, hit enter on this option.
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.                                        Page 16
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.                                   BBSee Version 1.4
  1090.  
  1091. Chapter 5  Catalog option
  1092.  
  1093. The purpose of these functions is to improve disk maintenance of downloaded
  1094. files.  I  find that  I download a  large quantity of  files that start  to
  1095. accumulate in my download sub-directory.  Using the various options in this
  1096. section  will lessen  this problem,  and allow  you to easily  catalog your
  1097. downloaded files, on floppy disks.
  1098.  
  1099. 5.1  Analyze directory
  1100.  
  1101.      This  option  uses  the  batch  file  specifications  created  in  the
  1102.      configuration.   Reviewing what I do, should  assist you in creating a
  1103.      usable analyze.bat  file.  These  are implemented  as a batch  file so
  1104.      that  you may inspect the file prior to running it.  This sample could
  1105.      be further modified to meet your personal requirements.
  1106.  
  1107.      The default configuration functions as follows.  Files in the download
  1108.      directory are compared  with the  description database.   If they  are
  1109.      found  they are added  to a file,  by default, ANALYZE.BAT,   that can
  1110.      perform the   following operations  when executed.   Note that  in all
  1111.      cases batch options 2 and 3 will only work for .ZIP files.
  1112.  
  1113.      1.   File is copied from download to archive directory.
  1114.      2.   README.ROS  and READ_ME.TXT ( Rose  Media ads )  are removed from
  1115.           the ZIP file.
  1116.      3.   Comments  are removed from the  file ( This  requires a shareware
  1117.           package STRIPZIP).
  1118.      4.   Original file is deleted from the download directory.
  1119.  
  1120.      I  would recommend that if  you approximate my  archiving method, that
  1121.      you  also investigate  programs  such as  FILL or  ICOPY.   These will
  1122.      assist  in copying files from  this archive directory  to floppy disk,
  1123.      and they will maximize your floppy disk utilization.
  1124.  
  1125.      A second output file from this option is a list of files that were not
  1126.      found in the master database.  A single file, by default, NOTFOUND.ADD
  1127.      is created  that meets the specification for a BBS file listing.  This
  1128.      file  description can be edited with a text editor (the description is
  1129.      initially indicated  *Not Found*), and  can be imported  directly into
  1130.      the  database.  BBSee  does not like  the tab character  so be careful
  1131.      when you use your text editor.
  1132.  
  1133.  
  1134. 5.2  Catalog floppy
  1135. 5.3  Uncatalog floppy
  1136.  
  1137.      Both of these functions will work by inserting the desired floppy into
  1138.      the  appropriate disk drive.  Additionally a floppy can be uncataloged
  1139.      by volume label name.
  1140.  
  1141.  
  1142.                                        Page 17
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.                                   BBSee Version 1.4
  1151.  
  1152.      A floppy can be cataloged, if it meets two criteria, a) the floppy has
  1153.      a volume label  and b) a  matching volume label  has not already  been
  1154.      cataloged.  If files exist on the floppy that do not have descriptions
  1155.      in  the BBSee  master  database,  you  may wish  to  create  a  Floppy
  1156.      description file,  edit it  with the  proper descriptions, and  import
  1157.      this edited  file into BBSee,  with an unknown  category.  If  not, an
  1158.      entry with the  'Catalog only'  description will be  entered into  the
  1159.      master database.
  1160.  
  1161.      If  you insert  a floppy  with a  volume label  that has  already been
  1162.      cataloged, BBSee  will ask if you want to replace the existing catalog
  1163.      entry for that label.  Be careful when you label your floppies, as you
  1164.      can easily overwrite your catalog database entries, on an update.
  1165.  
  1166. 5.4  Label floppy
  1167.  
  1168.      This  option allows you to label floppies  without exiting to DOS.  If
  1169.      there  is no  volume  label on  your floppy,  a  default unique  label
  1170.      assigned by BBSee  will be displayed.  You can edit  or change this if
  1171.      you desire.
  1172.  
  1173.      The default  layout of this name is established in BBSetup.  There are
  1174.      two components, the name component and the number component.  The name
  1175.      component is  up to seven  characters, the  number component is  up to
  1176.      9999.  They must be  separated by  a space.  BBSee will  increment the
  1177.      number component automatically to allow for the unique label, and will
  1178.      force the number to have a  4 character length, by padding with zeros,
  1179.      to  make Catalog  listings  sequential.   BBSee  does not  modify  the
  1180.      BBSEE.CFG file in performing this function.
  1181.  
  1182.      If  you  enter a  volume label  manually  using the  formula described
  1183.      above, it is also possible to an incremental list of files,  ie CFILES
  1184.      0001, TELIX  0001.  Subsequent calls  to the label  function will give
  1185.      you the next available number.  Remember to include the leading zeroes
  1186.      for the first count that you input.
  1187.  
  1188.      If a volume label  exists on a floppy,  that will be the label that is
  1189.      shown  in the input window.  If  you desire to use the automatic label
  1190.      feature described above, you must first delete the label, by inserting
  1191.      spaces, and  then call  the label  function again,  to get  the proper
  1192.      default label.
  1193.  
  1194. 5.5  Make Catalog File
  1195.  
  1196.      This option  creates a  list of  files you  have cataloged, sorted  by
  1197.      either disk volume, or filename.   This list is useful as it is output
  1198.      in a format that BBSee can use as input.  This allows for sharing file
  1199.      lists with friends and other user groups.
  1200.  
  1201.  
  1202.  
  1203.                                        Page 18
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.                                   BBSee Version 1.4
  1212.  
  1213. 5.6  Cross Reference
  1214.  
  1215.      A catalog cross reference creates  a list of files you have  cataloged
  1216.      against  a  list  from  another  source.    The  list  is  a  list  of
  1217.      differences.  This should  make it easier to determine  what to upload
  1218.      to other sources.  Remember to  check a BBS before uploading to ensure
  1219.      that you don't  upload something  they received since  your last  file
  1220.      import.
  1221.  
  1222. 5.7  Describe Floppy
  1223.  
  1224.      This option  allows for  the creation  of a  file, in PCBoard  format,
  1225.      containing  any file descriptions  associated with files  on a floppy.
  1226.      If a file has no description in the master database, the message, 'Not
  1227.      in BBSee  catalog' is output to  the file, in the  description.  Since
  1228.      this file is in PCBoard format, if you edit the 'not in BBSee catalog'
  1229.      message with a more  appropriate description and then import  the file
  1230.      into BBSee, the master database will have more valid data.
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.                                        Page 19
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.                                   BBSee Version 1.4
  1273.  
  1274. Chapter 6  Tag option
  1275.  
  1276. When file searches  take place, it is  possible to 'tag'  a file.  This  is
  1277. done using  the <Keyboard +> key, or the T  key.  Files can be individually
  1278. untagged with the <Keyboard  -> key or the  U key.  Additional  options are
  1279. available in  the Word Search  Option, <Ctrl T>  tags a screen  of filename
  1280. 'hits', and <Alt  T> tags all screens  of filename 'hits'.   File tags  are
  1281. indicated with the  character.  
  1282.  
  1283. 6.1  Delete tagged file
  1284.  
  1285.      This  option  deletes  all tagged  files  from  the  database.   These
  1286.      filenames are permanently  removed from  the database.   In fact  they
  1287.      cannot  be re-added (See Appendix E).   This feature is to ensure that
  1288.      you don't have to delete the same files every time a complete BBS file
  1289.      list  is subsequently imported, for  update purposes.   This will also
  1290.      remove the tags.
  1291.  
  1292. 6.2  Create download file
  1293.  
  1294.      This  option creates  a download  file in  the tagged  file dir.   The
  1295.      format of the filename  is bbsname.{defaultextension} ie. SYNAPSE.DOW.
  1296.      The layout  of  this  file  is  a simple  sequential  file  of  tagged
  1297.      filenames that are  found in the master database on  the selected BBS.
  1298.      This will remove all tags from the selected  BBS, unless the indicated
  1299.      bbsname has no tagged files.
  1300.  
  1301. 6.3  Remove tags
  1302.  
  1303.      The tag  is removed from every  tagged file.  All  file information is
  1304.      left unchanged.
  1305.  
  1306. 6.4  View tags
  1307.  
  1308.      Provides  an on  screen listing  of all  tagged files,  as well  as an
  1309.      estimate of how long a  file transfer of these files will take.
  1310.  
  1311. 6.5  Create upload files
  1312.  
  1313.      This option  creates an output list  of all tagged files,  in a format
  1314.      that can be edited to use with  automatic file uploading facilities of
  1315.      scripts Liberator,  Access (QMM), Telix  Square and CatCalls,  and the
  1316.      new program Intellicomm.    The choice of  these formats is configured
  1317.      in BBSetup.
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.                                        Page 20
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.                                   BBSee Version 1.4
  1334.  
  1335.      The options to use in BBSetup are:
  1336.           Q - QMM/Access
  1337.           L - Liberator
  1338.           W - CatCalls - Wildcat 3.0
  1339.           2 - CatCalls - Wildcat 2.0
  1340.           S - Telix Square
  1341.           I - Intellicomm
  1342.  
  1343.      Note  that the Upload and Download  file extension need to match those
  1344.      specified for  use with your program.   I will attempt  to add support
  1345.      for  additional   Upload/Download  types   if  the  appropriate   file
  1346.      specifications are provided to me.  See Appendix 'A'
  1347.  
  1348. 6.6  Output tags to disk
  1349.  
  1350.      This  option creates  an output  list of all  tagged files  in PCBoard
  1351.      format.  This  file is opened in  append mode.  Tags are  removed from
  1352.      all tagged files.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.                                        Page 21
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.                                   BBSee Version 1.4
  1395.  
  1396. Chapter 7  Using the program
  1397.  
  1398. I have  included a file, SAMPLE,  that is simply a  small NEWFILES.DAT file
  1399. from SYNAPSE  to help  you test  BBSee.   You can later  expand the  actual
  1400. master  database by importing your BBS's allfiles listings.  I suggest that
  1401. you investigate  various exclusion  word combinations  in BBSETUP  prior to
  1402. creating your 'good'  database.  Once you've got the hang of it, you can of
  1403. course import files from any sources you want.
  1404.  
  1405. The first step, which I  again emphasize as probably the most  important is
  1406. to understand  how to  configure all  the directories properly.   Read  the
  1407. configuration section, if you haven't already.
  1408.  
  1409. It is now time to run the program, that is after all why you've read all of
  1410. this in the first place.
  1411.  
  1412. 1.   Run BBSETUP.EXE at  the DOS prompt.  I would recommend that you make a
  1413.      temporary subdirectory  for this  purpose.   Files can  be moved  at a
  1414.      later date.
  1415.  
  1416. 2.   Continue through BBSetup configuration.
  1417.  
  1418. 3.   Place  the  desired   file(s)  to  be  imported  in  your  description
  1419.      directory.
  1420.  
  1421. 4.   Run BBSee and select the File Import Option.
  1422.  
  1423. 5.   Enter the filename (wildcards are possible).
  1424.  
  1425. 6.   When you are prompted to Select a BBS, moving the cursor, or selecting
  1426.      the first character, will scroll through valid options.
  1427.  
  1428. 7.   <Enter> to add files, <Esc> to abort
  1429.  
  1430. 8.   When the file update is complete you are free to explore the program.
  1431.  
  1432.  
  1433. Enjoy, and good luck!
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.                                        Page 22
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                                   BBSee Version 1.4
  1456.  
  1457. Chapter 8  Command line arguments
  1458.  
  1459. 1.   BBSEE [primary word [qualifier 1 [qualifier 2 [exception 1]]] ]
  1460.  
  1461.      This  will  start word  searches directly.    Blanks are  not allowed,
  1462.      unless they are enclosed in quotes.
  1463.  
  1464.      ie BBSEE QMAIL
  1465.           searches all filename and descriptions with qmail in them
  1466.  
  1467.          BBSEE QMAIL READ OFFLINE CIS
  1468.           search  all filenames and descriptions  with qmail and  ( read or
  1469.           offline) but not containing the string cis
  1470.  
  1471. 2.   BBSEE [-u [[drive:]directory]filename[ext] ]
  1472.  
  1473.      This option allows  for automatic  updates of Qmail  packages, if  you
  1474.      have configured  the Source/BBS name  to be the  same as that  of your
  1475.      mail package.  The default extension is .QWK.
  1476.  
  1477.      ie.  BBSEE -u SYNAPSE    
  1478.           update  the  master database  with  files  from the  newfiles.dat
  1479.           contained in synapse.qwk in the default mail directory.
  1480.  
  1481.           BBSEE -U C:\MAIL\SYNAPSE.QWK
  1482.           as above but override using the default mail directory.
  1483.  
  1484.  
  1485. 3.   BBSEE [-i [[drive:]directory]filespec Source ]
  1486.  
  1487.      This option allows for automatic importation of a file  list using the
  1488.      corresponding source.
  1489.  
  1490.      ie.  BBSEE -I *.* SYNAPSE
  1491.           update  the master  database  with  all  files in  the  temporary
  1492.           directory for the source SYNAPSE.
  1493.  
  1494.           BBSEE -i D:\MYDIR\FILES.LST BBS1
  1495.           update  the  master  database  with descriptions  from  the  file
  1496.           FILES.LST contained in directory D:\MYDIR for the source BBS1.
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.                                        Page 23
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                                   BBSee Version 1.4
  1517.  
  1518. Appendix A  Registration Information
  1519.  
  1520. I  have tried  to keep the  price for  the BBSee  package extremely  low to
  1521. encourage people to  register.  At these low prices, if you use BBSee there
  1522. should be no  reason to NOT  register.  I plan  to add functionality  which
  1523. BBSee does not  yet have, however this will only come  into being with your
  1524. support.  The pricing for BBSee is as follows:
  1525.  
  1526. #1 $10.00 A license to use BBSee Advanced and an Activation Key, which will
  1527.           provide  for  14  BBS's  in   your  master  database  and  Colour
  1528.           configuration.
  1529. #2 $20.00 #1  plus  a  floppy  containing  any  new  utilities  and  import
  1530.           functions,  a program to  install the Activation  Key, support in
  1531.           use of the product and notification of upcoming releases.
  1532. #3 $25.00 #2  plus automatic  delivery of  version 2,  whether I  decide to
  1533.           release it as shareware or not.
  1534. #4 $ 5.00 A license to use the shareware version of BBSee and an Activation
  1535.           Key, to eliminate registration notices.
  1536. #2 $15.00 #4  plus  a  floppy  containing  any  new  utilities  and  import
  1537.           functions, a program  to install the  Activation Key, support  in
  1538.           use of the product and notification of upcoming releases.
  1539.  
  1540. Bank  or postal  money orders should  be sent  when possible.   Please make
  1541. these out to Martin Vallevand.  If you  send me a cheque I will wait for it
  1542. to clear, before I mail out anything.  All orders must be pre-paid.
  1543.  
  1544. In Canada  these prices are  in Canadian dollars.   Ontario residents  also
  1545. must include the 8% PST.
  1546.  
  1547. All  orders  from outside  of  Canada must  be paid  in  $US dollars.   The
  1548. exchange difference  will also be used to pay the difference in postage and
  1549. applicable taxes.   Money orders are preferred.  If you  send a cheque, (on
  1550. American banks only), add $5 to the appropriate cost. 
  1551.  
  1552. These prices are subject to change at any time. 
  1553.  
  1554. If you are the author of a useful shareware package, and you send me a copy
  1555. of  your product, registered and licensed in  my name, I will either return
  1556. your package, or more likely, register  you and send you the activation key
  1557. to for BBSee Advanced.  Barterware?
  1558.  
  1559. I can be reached at 
  1560.  
  1561.      Martin Vallevand
  1562.      Suite 100
  1563.      56 Fourth Avenue
  1564.      Ottawa, Ontario
  1565.      K1S 2L2
  1566.  
  1567.  
  1568.  
  1569.                                        Page 24
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                                   BBSee Version 1.4
  1578.  
  1579. for  further information  on obtaining  this package.   I  am also  open to
  1580. suggestions on  methods of improving BBSee,  by adding new functions  or by
  1581. enhancing existing methods.
  1582.  
  1583. I cannot respond to  letters or phone calls  from users who have  not opted
  1584. for  the purchase  of  product support.     Also  I  cannot return  a  disk
  1585. forwarded to  me with a  BBS listing,  or other information,  unless return
  1586. CANADIAN postage is also enclosed.
  1587.  
  1588. I  can also be reached at  SYNAPSE BBS.  This BBS  is an excellent IBM-only
  1589. PCBoard BBS  located in Gatineau, Quebec, (very near Ottawa, the Capital of
  1590. Canada).   The SYNAPSE Sysop, Daniel Coulombe  has graciously allowed me to
  1591. use his BBS as a 'home' for BBSee.   New users are authorized two weeks  to
  1592. evaluate the BBS.  The phone numbers for the public nodes are
  1593.  
  1594.           ╔═════════════╣ 12 Phone Lines ╠═════════════╗
  1595.           ║ Node  1:      (819) 561-5268 - HST-DualStd ║
  1596.           ║ Node  2:      (819) 243-7179 - CompuComm96 ║
  1597.           ║ Node  3:      (819) 561-6745 - HST-DualStd ║
  1598.           ║ Nodes 4,8:    (819) 243-0306 - HAYES 9600  ║
  1599.           ║ Nodes 5,9,10: (819) 561-4321 - v.32        ║
  1600.           ║ Nodes 6,7:    (819) 561-3740 - HST 14.4K   ║
  1601.           ║ Node  11:     (819) 561-0981 - HST-DualStd ║
  1602.           ║ Node  12:     (819) 561-0950 - v.32        ║
  1603.           ╚════════════════════════════════════════════╝
  1604.  
  1605. I  also monitor many relevant conferences on Smartnet, Nanet, RelayNet, and
  1606. IntelecNet.  Although I cannot guarantee a reply, you may try to contact me
  1607. through these networks.
  1608.  
  1609. I  will attempt  to  maintain the  latest  version of  all BBSee  shareware
  1610. products on SYNAPSE  BBS.  Presently, an account has been  set up for BBSEE
  1611. USER with  a password of VISITOR  for the sole purpose  of your downloading
  1612. the current BBSee files.  The format for this file  is BBSEEnn.ZIP where nn
  1613. is the version number.  The 'Extra' disk is also available as BBSEEnnX.ZIP.
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.                                        Page 25
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.                                   BBSee Version 1.4
  1639.  
  1640. Appendix B  Program Return Codes
  1641.  
  1642. 0    Normal exit
  1643.  
  1644. 1    Not authorized
  1645. 2    Could not open BBSEE.CFG for read
  1646. 3    Invalid BBSEE.CFG
  1647. 4    Configuration aborted
  1648. 5    Could not open BBSEE.CFG for write
  1649. 6    Error writing BBSEE.CFG
  1650. 7    Could not open master database
  1651. 8    Could not create master database
  1652. 9    Could not open master filename index
  1653. 10   Could not create master filename index
  1654. 11   Could not open delete index
  1655. 12   Could not create delete index
  1656. 13   Could not open floppy catalog database
  1657. 14   Could not create floppy catalog database
  1658. 15   Could not open catalog filename index
  1659. 16   Could not open catalog volume index
  1660. 17   Not enough memory for BBSee
  1661. 18   Input file error
  1662. 19   Could not open add file
  1663. 20   Could not open error file
  1664. 21   Could not open download file
  1665. 22   Invalid syntax on -u
  1666. 23   File not found on -u
  1667. 24   Could not open master database file for word search
  1668. 25   Could not open output catalog file
  1669. 26   Could not open cross reference file
  1670. 27   Index error - rebuilt index
  1671. 28   Could not open upload file
  1672. 29   Could not open duplicate file
  1673. 31   No NEWFILES.DAT or error in UNZIP in batch .qwk file
  1674. 32   Error on batch import option
  1675. 33   No filename specified on -u
  1676. 34   Import failed on -u
  1677. 35   BBS name not found
  1678. 36   Could not open floppy description file.
  1679. 37   Error on -i option in import.
  1680. 38   Error on -i option, source name not found.
  1681. 39   Error on -i option, Input file not found.
  1682. 40   Conversion error 
  1683. 41   Database add error
  1684.  
  1685.  
  1686. The  remedy  for many  of  these  errors will  be  to  increase the  FILES=
  1687. statement in your CONFIG.SYS file.
  1688.  
  1689.  
  1690.  
  1691.                                        Page 26
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.                                   BBSee Version 1.4
  1700.  
  1701. Appendix C  Cursor Movement and Editing Keys
  1702.  
  1703.                   Cursor Movement
  1704.                   ---------------
  1705.  
  1706.           Arrow keys      - cursor movement
  1707.           Ctrl-LeftArrow  - word left
  1708.           Ctrl-RightArrow - word right
  1709.           Home            - beginning of field
  1710.           End             - end of line/field
  1711.           Ctrl-Home       - beginning of first field
  1712.           Ctrl-End        - end of last field
  1713.           Tab             - next field
  1714.           Shift-Tab       - previous field
  1715.  
  1716.                 Inserting and Deleting
  1717.                 ----------------------
  1718.  
  1719.           Ins             - toggle insert mode
  1720.           Del             - delete character at cursor
  1721.           BackSpace       - delete character left
  1722.           Ctrl-BackSpace  - delete word left
  1723.           Ctrl-T          - delete word right
  1724.           Ctrl-U          - delete to end of field
  1725.           Ctrl-Y          - delete to end of form
  1726.  
  1727.                  Other Editing Keys
  1728.                  ------------------
  1729.  
  1730.           Enter           - process current field
  1731.           Ctrl-Enter      - process all fields
  1732.           Ctrl-R          - restore field
  1733.           Esc             - abort data entry
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.                                        Page 27
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                                   BBSee Version 1.4
  1761.  
  1762. Appendix D  Import Usage
  1763.  
  1764. Attempting  to import file  description lists  into BBSee  that are  not in
  1765. PCBoard  format, can cause a  lot of problems.   To overcome  some of these
  1766. problems, a utility program, IMPORT.EXE is included in the BBSee package to
  1767. assist in the  import process.  The function of this  program is to convert
  1768. files into a  usable PCBoard-like  data structure.   All non-PCBoard  files
  1769. should be converted  with this program, before  you attempt to import  them
  1770. into BBSee.
  1771.  
  1772. The syntax to the IMPORT program is
  1773.  
  1774. IMPORT {sourcename} {destname} pdm
  1775.  
  1776. p    directs  the number  of passes  that IMPORT  makes on  the file.   The
  1777.      choice  is 1 or 2.  Some BBS  listings require two passes to eliminate
  1778.      CR/LF, and Formfeed problems.
  1779.  
  1780. d    directs the date determination  of the import,  Y indicates  to IMPORT
  1781.      to swap  the day  and month  fields   (ie the  format is MM-DD-YY),  N
  1782.      indicates not to swap the day and month, and C  indicates to check for
  1783.      the  date format.   Of  course if  all days  are <  13 the  check will
  1784.      indicate not to swap the day and month
  1785.  
  1786. m    directs the mode of the import.  IMPORT will automatically try to (the
  1787.      A option) determine the appropriate columns that it uses in the import
  1788.      process.  You  can override this if automatic mode  does not produce a
  1789.      workable PCBoard-like listing, by  using the M (manual) option.   This
  1790.      mode  will  allow you  to manually  enter  column details  for various
  1791.      fields.  The filename  and description fields must be entered,  if the
  1792.      size and/or  date are missing,  indicate this  by entering  0 for  the
  1793.      start and stop column locations.
  1794.  
  1795. The default if the pdm options are omitted is   2CA
  1796.  
  1797. If the  automatic mode of IMPORT  works with your description  list,  BBSee
  1798. can also perform  the automatic conversion.   Input AUT (automatic)  in the
  1799. BBSetup for  the  appropriate  BBS,  and  enter  the  pd  (pass  and  date)
  1800. parameters as determined above.
  1801.  
  1802. If you have a BBS listing from a major BBS that does not work automatically
  1803. with IMPORT I  would very much appreciate it  if you would send me  a disk,
  1804. containing a sample,  and I will attempt to  incorporate its structure into
  1805. the automatic import.  See Appendix A for information on contacting me.
  1806.  
  1807. Other utilities  for file conversion  may be  included on the  extras disk.
  1808. See the README.2ND file.
  1809.  
  1810.  
  1811.  
  1812.  
  1813.                                        Page 28
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.                                   BBSee Version 1.4
  1822.  
  1823. Appendix E  Database Packing
  1824.  
  1825. Most database packages, do not actually delete files  from a database, they
  1826. simply mark  the files for deletion.   The BBSee database  is no exception.
  1827. To reclaim this space it is necessary to  'pack' the database.  In addition
  1828. to  reclaiming disk  space, (vis-a-vis  a random  un-packed database),  the
  1829. packed file is maintained in  alphabetical order.  Due to the nature of the
  1830. BBSee database, an undelete feature, before unpacking, is not possible.
  1831.  
  1832. To pack  the BBSee master  database, run  the program PACBBSEE  at the  DOS
  1833. prompt,  in a BBSee directory.  PACBBSEE  will read your BBSEE.CFG file and
  1834. automatically pack the master  database.  During the PACBBSee  operation, a
  1835. record count will be displayed on the screen.
  1836.  
  1837. Note that to use this program, a new file is actually created, and your old
  1838. file is maintained, in case  a problem is encountered.  You  will therefore
  1839. require  disk space  equal to that  of you  original database  and index to
  1840. complete the  database pack.  Because  of the extensive hard  disk activity
  1841. required, this process  can take a considerable amount of time.   It is not
  1842. essential  to the operation of BBSee, and  disk savings can usually only be
  1843. achieved after a large number of imports.  I would  pack the database after
  1844. the all of your bbs allfiles listings are included.
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.                                        Page 29
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.                                   BBSee Version 1.4
  1883.  
  1884. Appendix F  Deleted File List Maintenance
  1885.  
  1886. Filenames that  you delete from the  master database are added  to an index
  1887. file (the .DEL file)  so that they are not added to the database again.  At
  1888. times you may wish to review your deleted files, and  allow certain deleted
  1889. files to be  added as your computing requirements change.   To do this, the
  1890. following steps should be followed.
  1891.  
  1892. Step 1.
  1893.  
  1894. The first step is to create an ASCII file of your present .DEL file.
  1895. The program READDEL.EXE will read your present .DEL file and output it
  1896. to standard output.  The format to view the file on the screen is
  1897. READDEL {master  delete file}   To  trap standard output  to a  file it  is
  1898. necessary to use the DOS redirect command.   The syntax for the redirect of
  1899. READDEL is:
  1900.  
  1901.      READDEL {master delete file} > {filename}
  1902.  
  1903. Care should be taken here as DOS does not prevent you from overwriting
  1904. a file on a redirect.
  1905.  
  1906. This program  can be used  to view the deleted  file list by  reviewing the
  1907. above file, or omitting the > filename.
  1908.  
  1909. Step 2.
  1910.  
  1911. The second step in editing the .DEL is to use an ASCII text editor on
  1912. the filename output in the previous step.  Remove all the lines
  1913. containing filenames that you no longer wish excluded.  You can also add
  1914. filenames to this file at this point, that will cause the entered
  1915. filenames to be removed from the master database in the next step.
  1916.  
  1917. Ensure that you use DOS naming rules when entering these filenames, and
  1918. do not add a trailing dot.  DO NOT include the following extensions if
  1919. you are manually entering filenames.
  1920.  
  1921.    ZIP, PAK, COM, LZH, EXE, ARC, SDN, GIF, ARJ, TXT,
  1922.    DOC, ZOO, BAT,  and SYS
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.                                        Page 30
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.                                   BBSee Version 1.4
  1944.  
  1945.  
  1946. Step 3.
  1947.  
  1948. The third step is to write a new .DEL file using the WRITEDEL.EXE
  1949. program.  This program, will read the list that you have edited above,
  1950. delete records from the master database if necessary, and create a new
  1951. .DEL file.  The syntax for use of this program is:
  1952.  
  1953.      WRITEDEL {input file} {output file}
  1954.  
  1955. The output file is the name of you master .DB and .DEL files without an
  1956. extension.   It will not overwrite your  present .DEL file.  You must first
  1957. delete  (or  rename) the  appropriate .DEL  file.   If  you don't  run this
  1958. program  from your database directory, ensure that the output file includes
  1959. the proper sub-directory information.
  1960.  
  1961. WRITEDEL will check  to see if the input file is in the appropriate format.
  1962. This checking is not all inclusive so be careful.
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.                                        Page 31
  1997.